Skip to main content

Configuring the Attributes of Root Section

To configure the Root section properties, please consider the below points:

  1. Click on "Layout.Section root" in the Document Structure panel.

Image showing configuration panel for root section

  1. Observe the configuration panel opens. It has "root" written above it.

Also observe there are three categories:

  • Attributes
  • Conditions
  • Connection

Out of these you can only configure Attributes here. Conditions and Connection cannot be configured from this panel for root.

  1. Let us describe each of the options for the Attributes category :

Image showing various configuration fields for root section

a. Label - This the label of the root section. This is a text field. You can type the label in this field.

Please note

The label text will automatically become the name of the root section in the Document Structure Panel.

b. Show label - If you toggle this to "Yes", then the label text will display on the composition area.

Please note

If this field is set to "No", then it will supersede Divider and Description Show settings (discussed below)

c. Layout direction - You can select Horizontal or Vertical Layout directions in this field.

Vertical LayoutHorizontal Layout
Image showing Vertical layoutImage showing horizontal layout
If a vertical layout is selected, new elements will be added one below the other in a vertical mannerIf a horizontal layout is selected, new elements will be added rightwards to the previous one in a horizontal manner

d. Heading size - You can select the size of the heading in which you wish the label text to appear. Options from H1 to H6 are available. These are arranged in descending order of font size, with H1 being the largest.

Please note - Justify children and Align children

Justify children and Align children are similar to each other in certain ways, and derive their effect from the Layout direction value (defined above in c.). Therefore, we shall discuss these two parameters together in a table.

It is worth observing that both Justify children and Align children have the same set of seven options.
Image showing options available for align

We shall discuss the behaviour of Justify and Align for each of these seven options.

e. Justify childrenf. Align children
DefinitionThis will justify the children along the line of the axis of the layout direction. Therefore, if the layout direction is selected as vertical, the justify will arrange children top-down, while if layout direction is selected as horizontal, the justify will arrange children left-right.This will align the children across the line of the axis of the layout. Therefore, if the layout direction is selected as vertical, the align will arrange children left-right, while if layout direction is selected as horizontal, the justify will arrange children top-down.
Layout direction - VerticalImage showing justify verticalImage showing align vertical
Layout direction - HorizontalImage showing justify horizontalImage showing align horizontal

Next, we will take a look the seven options and see how the system behaves for Vertical / Horizontal - Justify pair. You can then deduce how the system will arrange children across the layout axis for align.

Option DefinitionVerticalHorizontal
StartItems are packed toward the start of the layout direction. Top for vertical, Left for horizontalImage showing start justify verticalImage showing start justify horizontal
CenterItems are centered along / across the lineImage showing center justify verticalImage showing center justify horizontal
EndItems are packed toward the end of the layout direction. Bottom for vertical, Right for horizontalImage showing end justify verticalImage showing end justify horizontal
StretchItem fills the container along the layout direction. Height for vertical, Width for horizontalImage showing stretch justify verticalImage showing stretch justify horizontal
AroundItems are evenly distributed along the line with equal space around them. Note that visually the spaces aren’t equal, since all the items have equal space on both sides. The first item will have one unit of space against the container edge, but two units of space between the next item because that next item has its own spacing that applies.Image showing around justify verticalImage showing around justify horizontal
BetweenItems are evenly distributed along the line; first item is on the start line, last item on the end line.Image showing between justify verticalImage showing between justify horizontal
EvenlyItems are distributed along the line so that the spacing between any two items (and the space to the edges) is equal.Image showing evenly justify verticalImage showing evenly justify horizontal

g. Show divider - if this is toggled "Yes", then a divider line appears below the label header.

h. Show description - if this is set to "Yes", then the description text will appear below the label header.

i. Fill container - if this is set to "Yes", the subject element fills up the space of the parent container. This does not have any effect for the root section, as it has no parent.

j. Description - this is a text field where you can type the description of the form / header.

k. Css Class Names - here you can define the existing Css Classes and the design of the root section will pick up the styling based on the Css Class.